@gitbeaker/requester-utils

What is @gitbeaker/requester-utils?

@gitbeaker/requester-utils is a utility package designed to facilitate HTTP requests, particularly in the context of interacting with GitLab's API. It provides a set of tools to simplify the process of making authenticated requests, handling responses, and managing configurations.

What are @gitbeaker/requester-utils's main functionalities?

Authenticated Requests

This feature allows you to create a requester function that automatically includes authentication headers in your HTTP requests. The code sample demonstrates how to create a requester and make a GET request to fetch projects.

const { createRequesterFn } = require('@gitbeaker/requester-utils');

const requester = createRequesterFn({
  host: 'https://gitlab.example.com',
  token: 'your_access_token',
});

requester.get('/projects')
  .then(response => console.log(response))
  .catch(error => console.error(error));

Custom Request Configurations

This feature allows you to customize various request configurations such as timeout settings. The code sample shows how to set a custom request timeout.

const { createRequesterFn } = require('@gitbeaker/requester-utils');

const requester = createRequesterFn({
  host: 'https://gitlab.example.com',
  token: 'your_access_token',
  requestTimeout: 5000,
});

requester.get('/projects')
  .then(response => console.log(response))
  .catch(error => console.error(error));

Handling Responses

This feature provides a way to handle responses and errors effectively. The code sample demonstrates how to check the response status and handle errors.

const { createRequesterFn } = require('@gitbeaker/requester-utils');

const requester = createRequesterFn({
  host: 'https://gitlab.example.com',
  token: 'your_access_token',
});

requester.get('/projects')
  .then(response => {
    if (response.status === 200) {
      console.log('Projects:', response.data);
    } else {
      console.error('Error:', response.statusText);
    }
  })
  .catch(error => console.error('Request failed:', error));

Other packages similar to @gitbeaker/requester-utils

axios

Axios is a popular promise-based HTTP client for the browser and Node.js. It provides similar functionalities such as making HTTP requests, handling responses, and managing configurations. Compared to @gitbeaker/requester-utils, Axios is more general-purpose and widely used across various projects.

node-fetch

Node-fetch is a lightweight module that brings `window.fetch` to Node.js. It is used for making HTTP requests and handling responses. While it offers similar functionalities, it is more minimalistic compared to @gitbeaker/requester-utils, which is tailored for GitLab API interactions.

request

Request is a simplified HTTP client for Node.js with a user-friendly API. It provides functionalities for making HTTP requests and handling responses. Although it is similar in purpose, it is more feature-rich and flexible compared to @gitbeaker/requester-utils.

README

---

^{My open source work is supported by the community}

^{Special thanks to:}

---

Utility for creating custom wrappers around the @gitbeaker/core GitLab SDK.

Table of Contents

• Usage
• Testing
• FAQ
• Contributors
• Changelog

Usage

Browsers	Load @gitbeaker/requester-utils directly from esm.sh <script type="module"> import { RequesterUtils, BaseResource } from 'https://esm.sh/@gitbeaker/requester-utils'; </script>
Deno	Load @gitbeaker/requester-utils directly from esm.sh import { RequesterUtils, BaseResource } from 'https://esm.sh/@gitbeaker/requester-utils?dts';
Node 18+	Install with npm install @gitbeaker/requester-utils, or yarn add @gitbeaker/requester-utils import { RequesterUtils, BaseResource } from '@gitbeaker/requester-utils';

Contributors

This started as a fork from node-gitlab-legacy but I ended up rewriting much of the code. Here are the original work's contributors.

Changelog

40.6.0 (Sat Oct 19 2024)

:tada: This release contains work from a new contributor! :tada:

Thank you, Ryan Smith (@Incisive), for all your work!

✨ Feature

• @gitbeaker/core
  • Implement MergeRequests.allIssuesRelated() #3642 (@kouak)

🔨 Technical Debt

• @gitbeaker/rest
  • Request Retry Error Message Adjustment #3626 (@Incisive @jdalrymple)

🗃️ Typescript Definitions

• @gitbeaker/core
  • Updating missing expanded types for Issues.all #3640 (@jdalrymple)
  • Updating allowedToCreate type to an array #3641 (@jdalrymple)

Authors: 3

• Benjamin Beret (@kouak)
• Justin Dalrymple (@jdalrymple)
• Ryan Smith (@Incisive)

---